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OCTAL EDITOR 



FEATURES 



The OEDIT program provides you with powerful tools 
for editing a disk file. Using OEDIT, you can: 

• Examine and modify disk words 

• Search your file for a specific word 

• Dump any portion of your file to terminal or printer 

• Fill any portion of your file with any word 

• Extend any random or sequential file 

You may examine your file in any of four different for- 
mats, choosing any number base ranging from 2 through 
16 for displaying and altering the contents of the file. 



INVOKING OEDIT 



Invoke OEDIT by typing: 
OEDIT FILENAME ) 



( } = carriage return) 



Filename specifies any file existing under RDOS. If you 
fail to enter "filename", OEDIT prints: 

ERROR: NO FILENAME SPECIFIED 

and control returns to CLI. If OEDIT cannot find "file- 
name" in your RDOS system directory, it prints: 

ERROR: A NON-EXISTENT FILE: FILE XXX 

and returns control to CLI. 

On finding "filename". OEDIT prints a carriage return/ 
line feed and a period (. ), indicating that you may now 
enter your commands. 

FORMAT 



Commands consist of "expressions" followed by a com- 
mand code. You may use either of two types of com- 
mands: Local and Escape. Local commands concern 
specific operations on an expression (and only on that 
expression), while Escape commands perform more 
general functions, such as selecting a number base for 



OEDIT output. Local commands do not use the ESC 
character (shown in the manual as $); otherwise, both 
commands have the following format: 

[expressionl [$1 command code 

(where brackets, [ ], denote optional arguments). 

Expression addresses some word location in your file, 
or it" mav hp infprnrptprl aa a iralno tn ha ci-n-rari t-^ tt^..^ 

file; or, expression may simply be a value or a sequence 
of numbers, operators or alphanumeric characters that 
you want calculated, with the result displayed in the 
format of your choice. The command code governs which 
interpretation OEDIT will use. 

When you wish to address your file, "expression" has 
either of the following forms : 

displacement 

or 
record number : displacement 



Displacement addresses a word location in your file 
that you want accessed. 

Record number : displacement also addresses some 
word location in your file, and is an optional addressing 
feature in OEDIT. 

You may choose to consider your file as segmented into 
"records" of some specific length, and then access any 
or all of these records while editing. Rather than 
typing the word location for each entry, you may enter 
a record length into the record size register (see $L 
command), then address your file with record number : 
displacement, where displacement pertains to that 
record you are editing. This addressing scheme lends 
itself handily to certain file types, eliminates time- 
consuming external calculations, and enhances accuracy. 

You can also specify a base address to be added into 
all address calculations. You set this with the base 
register (see $B command); it has the default value 
until you set it. 

OEDIT computes the "effective" file address using the 
following method: 

base-address + (record- number * (record- length)) + 
displacement 
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The command code directs OEDIT to perform an opera- 
tion. A discussion of the two types of command codes. 
Local and Escape, follows the next topic. The sequence 
t A (typed by depressing the CTRL and A key simul- 
taneously) will abort any command. 



KEYBOARD CALCULATIONS 



OEDIT can calculate the value of any expression in a 
command. Expressions may contain operators +, 2. 
and ! (exclusive OR), numerics (including decimal 
digits), parentheses and alphabetic characters. You 
may request a calculation with both Escape and Local 
commands. 

The period character (. ) in OEDIT has two functions; 
used following numbers it indicates decimal notation, 
and used alone or in conjunction with operators it repre- 
sents the current displacement value. For example: 



OEDIT derives a file address of 24:11, and will display 
the contents of record number 24, displacement 11. The 
command code (in this case /) directs OEDIT to display 
the contents of the specified address for possible 
modification. 

Calculation arguments have the following forms : 

• Double precision octal or decimal number 

• " charactercharacter , where character is a single 
alphanumeric. The characters are packed left to 
right in a word with null fill. For example: 







"A = 040400 



"AA= 040501 



LOCAL COMMANDS 



14+. 



prints a 21 if the current displacement (last file address 
accessed) is 5. 

A period followed by an equal sign, ^, prints the current 
displacement. If you type 14.+.= OEDIT prints 23, 
again assuming the current displacement is 5. The 
first period tells OEDIT to interpret 14 as a decimal 
value; the second period is replaced by the value 5 in 
internal calculations. If you type: 

(10.+2)+(17-7) :4+5$C 

and the record register ($L) contains 100, 
OEDIT returns 24:11, and if you input: 

(2+5)-(4+2)= 

OEDIT returns the value I. Note that in the above 
examples, the expressions are simply values calculated 
and displayed. You are not accessing your file, nor are 
you storing some value to your file. The Local command 
=. and the Escape command $C_ specify the function: 
calculate and display the result. 

However, depending upon the command code, OEDIT can 
calculate the value of an expression (as in the above 
examples) and use the result to access your file. If you 
type: 



Local commands direct OEDIT to perform an operation 
on the expression you enter with the command. Escape 
commands (see the next section) generally have broader 
effects on OEDIT, such as specifying a certain number 
base for all output. 

A summary of Local commands follows: 



Local Command 
/ 



Description 

Open the current word, and display 
its contents in the current format. 

This command allows you to modify 
a word. For example: 

. 451/ 040501 

(Note the preceding period; this is 
a prompt for your command. ) You 
requested a display of location 451 
in your file. OEDIT printed its 
contents, in this case the value 
040501. You may wish to modify 
the contents of location 451, or you 
may wish to see what ASCII char- 
acters are equivalent to 040501 - 
see the next command. 



(10.+2) + (17-7) ; (4+.)/ 
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Local Command Description 



Apostrophe. Display the last word 
or expression in ASCII format. 
For example, 

. 451/ 040501 ^ AA 

Apostrophe directs OEDIT to dis- 
play the expression you enter, or 
the value it has just printed, in 
ASCII format. The apostrophe 
command does not open any loca- 
tion, nor does it store any value 
to your file. Apostrophe just 
translates expressions to their 
ASCII equivalent. (Thus, the 
ASCII equivalent of 40501 is AA. ) 

Left Arrow. Display the last word 
or expression in half-word format 
as two octal numtiers. For example, 

. 451/ 040501 1 AA ^2 101 101 

This example illustrates opening 
and displaying location 451 using 
local command /. OEDIT types 
040501; then you request that same 
word in ASCII format using Local 
command '_ (apostrophe). The 
last command, - , requests half- 
word format in octal; OEDIT 
complies by printing 101 101. 

Equal sign. Display the last expres - 
sion in word format in the current 
base. 

Again the local command =, like ' 
and - , supplies jrou with a different 
"filter" (so to speak) to view an 
expression. If the current output 
format is ASCII and you type . 451/ , 
OEDIT will type AA. If you then 
wish to see what AA looks like in 
word format, then use the command 
= and OEDIT will type the word 
equivalent of AA (which happens to 
be 040501 in base 8). 

The command line would look like: 

.451/ AA = 040501 



Asterisk. Display the last expres- 
sion as an octal word. 

This command overrides the current 
number base, and displays only in 
octal. (You control the number base 
with Escape command $N; see the 

nPVt Rf»c**If^Tl frvr CTvar>ifir»o ^ 
— „ ^„^ ^^v*^***^^. / 

Carriage Return. Store the result 
of the expression entered into the 
currently -opened word. If you do 
not enter an expression, or if no 
word is open, then carriao-e return 
is a no-op. For example: 

. 451/ 040501 _;_ AA "Bb} 

Here you key in the value BB, which 
alters the contents of location 451 
which previously held AA. 

. 451/ 040501 2 

Here you close location 451; no 
modification is made. 

Line Feed. Store the result of the 
expression in the currently- opened 
word, and display the next word. 



. 451/ 040501 
.452/ 056411 



•be; 



This example illustrates opening 
location 451, modifying it, then 
opening location 452 with a new 
command. The following command 
accomplishes hwth: 

. 451/ 040501 "BB< 

000452 056411 

Line feed (t ) closes location 451 
after modifying it to BB, then 
OEDIT prints the address of the 
next location, along with its contents. 

Up- Arrow. Store the result of the ex- 
pression in the currently- opened word, 
and display the previous location. 

. 451/ 040501 _t. 
000450 026377 
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Local Command 
» (cont'd) 



n]n 



Description 

In the above example, up- arrow 
closes location 451 without modifying 
it, since the programmer at the 
console did not enter any expres- 
sion after OEDIT displays its 
contents. OEDIT then types the 
address of the previous location, 
along with its contents. 

Byte format. You can enter bytes 
by opening a location, t3T3ing the 
value you want in the left byte, a 
right bracket, then the value you 
want in the right byte. For 
example: 

10/000000 101] 101 ) 
W040501 ■ AA 



Escape. Enter Escape Command 
Mode; the character following ESC 
($) is the command. 

ESCAPE COMMANDS 

Escape commands affect general functions in OEDITo 
To call an Escape command, type the ESCape key, then 
the command code. 

Escape commands terminate a command line. OEDIT 
expects one, and only one, character to follow escape. 
When you type that character, OEDIT performs some 
operation; no other information is requested of you. 
When OEDIT completes the task you called for with the 
command, it types a prompt, or opens a special register 
for modification. 

A brief summary of each escape command follows; you'U 
find a more detailed description in the next section. 



Escape Command 

$N (cont'd) 



$ (Escape) 



Escape Command 

$M 



$W 



$N 



Description 

Open the mask register for display 
and modification. You will need this 
register to search your file; it al- 
lows you to ignore bit positions in 
words within your file when you're 
searching for a specified value. 

Open the word register for display 
and modificationo You need this 
register for both Search and Fill 
commands. 

Open the number register for dis- 
play and modification. This register 
defines the output format for OEDIT. 
Your entries to this register direct 



$J 



$L 



$H 



$S 

$D 
$F 

$A 

$C 



$Z 



Description 

OEDIT to zero-suppress Its display 
of file words; treat words In your file 
as signed values, printing them 
accordingly; and display any word In 
your file In any number base from 
2 through 16. 

Open the Increment register for 
display and modification. This 
register governs searches, dumps 
and fills to your file. If you desire, 
you may direct OEDIT to search, 
dump and fill every ]th position in 
your file. If this register contains 
1, OEDIT accesses each word loca- 
tion in your file while performing 
these commands. 

Open the record size register for 
display and modification. An entry 
to this register allows you to refer 
to word locations in your file in 
terms of record number:displacement. 

Open the base address register for 
display and modification. This num- 
ber will be added to each address. 

Open the output device register for 
display and modification. The output 
device register directs OEDIT out- 
put from search and dump commands 
to either the input device or line 
printer. 

Search the file for a specific 16-bit 
value. 

Dump the specified file locations. 

Fill the specified file locations. 

Print the record number for the 
segment of your file presently in 
core. 

Calculate the preceding expression 
and print the result in terms of 
record number : displacement . IE 
no expression preceeds this com- 
mand OEDIT prints the current 
location. 

Close all files and return to CLI. 
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ESCAPE COMMAND DESCRIPTIONS 

Word ($W) and Mask ($M) Registers 

OEDIT allows you to search your file for any 16-bit 
value with the $S (search) command. As a prerequisite 
to searching your file, you must enter values into both 
the word and mask registers. The fill ($F) command 

plfio iiRPR fhp word r*acpi<5fAr fnr f-fi^ trains tttiti -njant 

inserted into your file. 

For searches, first set the word register to represent 
the value you're looking for in your file. Next, set the 
mask register to mask specific bits of the file words 
(if desired). While OEDIT searcheR, it ANDs the value 
in a file location with the mask register, then compares 
it to the contents of the word register. If they match, 
OEDIT types the file location and its contents. 

Both word and mask registers initially contain 0. If you 
leave them that way, and you request a search, all file 
locations match and your entire file will be printed. 

$W Opens the word register 

$M Opens the mask register 

Example: 

.$W 000000 40l) 

Open the word register and store 401 

.$M 000000 777) 

Open mask register and mask bits thru 6 

Search the entire file, and print those locations that 
have a value 401 in bit positions 7 thru 15; ignore bits 
thru 6. 

Number Register ($N) 

The number register governs the base of the number 
system (octal, decimal, etc.) OEDIT uses for printing 
fUe words. The number register can also specify zero 
suppress and sign control. You may choose any num- 
ber base ranging from 2 through 16. 



Code the number register as follows : 

Bit = 1 Treat the number as signed. 

Bit 1=1 Suppress leading zeroes 

Bits 12 - 15 = base Any integer from 2 through 16. 

Initially the number register contains 8. , so OEDIT will 
print values in octal, will not suppress leading zeroes, 

register for display and /or modification, type: 

$N 

Examples: 

. 33/ 000035 )_ 
.$N 000010 10. ) 

Display location 33 and close that location, then open the 
number register for display and modification. Current 
mode is octal 10 (base 8. ); change base to decimal (10. ) 
and close number register. 

,33/ 00029 2 

.|n^ 00010 40000+10.) 

Open location 33 for display; note that its contents 
are now displayed in decimal. Then open the number 
register, set bit 1 to 1 and set base to base 10. (decimal). 

.33/ 29 2 

.$N 16394 16.) 

Open location 33 again; note that leading zeroes are 
suppressed. Then open the number register again. 
Viewing its contents in decimal seems misleading, 
bat 16394^0 = 400008 + 10. Set number register to 
base 16., and close it. 

. 33/ OOID _) 

Now you see the contents of location 33 in base 16. 

Increment Register ($J) 

OEDIT uses the increment register in conjuction with 
three commands: DUMP, FILL, and SEARCH. After 
performing either a search, dump, or fill to the starting 
address in each of these commands, OEDIT adds the value 
in the increment register to derive the next location to 
search, dump or fill. 
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If you wish, for example, to examine every 10th word 
in your file, simply store 10, into the increment reg- 
ister rather than entering each word location separately, 
then request a dump, OEDIT will dump the first word 
in your file, then add the value in the increment register 
to the previous address, type out the contents of the 
new address and so on until it reaches the end -of -file, 

OEDIT will interpret the value in the Increment 
register as 1, since is meaningless in this context. 
You may enter negative values into the increment 
register to back up through your file while performing 
searches, dumps or fills. The contents of the increment 
register may not exceed the record length in the record 
size register; if record size = then you can put any 
value in the increment register. 

To open the increment register, type: 

$J 
Example : 

,$J 000001 12 ) 

This command opens the increment register for display 
and modification, and stores the value 12 g as the new 
increment. Any $S, $D or $F commands that follow 
will act only upon every tenth word location until you 
modify the increment register again. 

Record Size Register ($L) 

When you want to address your file with record number : 
displacement , type $L_ and enter a record length. The 
record size register is initially set to 0. Like all 
special registers, you can modify the contents of the 
record size register anytime; that is, you may choose 
to edit your file in terms of file displacement, then use 
record numbers, and later return to file displacement. 

Example: 

.$L 000000 _J 
, 126/ 034761 2 
,$L 000000 100 2 
. 1:26/ 034761 2 

Location 1:26 references file location 126 when record 
size = 100. 



Base Address Register ($B) 

When a set of data begins at an offset into a file, you 
can use the base register to display addresses using 
displacements from the base. The base address 
register is initially set to zero. Like other special 
registers, you may modify it at any point in your 
editing. 

Example: 

.$B 000000 2 
. 126/ 034761 2 
.$B 000000 100 2 
.26/ 034761 ) 



Location 26 in the last line refers to base + 26, i.e. , 
location 126. 

You can also use the base register together with the 
record size register. In this case, record numbering 
starts with the base. 

Example: 

.$B 000000 ) 
.|l 000000 J 
. 126/ 034761 2 
.$B 000000 100^ 2 
.|L 000000 10 2 
. 2:6/ 034761 

Location 2:6 equals the base + twice the record size 
+ 6, where the base is 100 and the record size is 10. 

Output Device Register ($H) 

You may direct output from searches and dumps to the 
line printer by entering a nonzero value in the output 
device register. Initially this register contains zero. 

Example: 

.$H 000000 l2 

Open output device register, store a 1, and close the 
register. All output from SEARCH ($S) and DUMP($D) 
commands is directed to the line printer until you reset 
this register to zero. 
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SEARCH Command ($S) 

This command searches all or part of your file for any 
16-blt value, prints file locations that contain that 
value, and the contents of those locations. Execute the 
following steps to perform a search: 

• Set the mask register to the mask desired for the 
search 

• Set the increment register to the desired increment 
value 

• Specify the SEARCH command, $S. 



Example: Find all words containing 016401 in your file. 

.$W 000000 16401) 
.$M 000000 ^T7 
.$J 0000005 Tj 



This sequence places the value you're seeking into the 
word register, sets a mask of no bits (-1 =177777), 
makes *"he s*^arch increm'^n*" 1 ^^t-iri oany*r-\^ac< t-v^e^ 
entire file. 

If it found any matches OEDIT would print them as: 



The SEARCH command ($S) will search your entire 
file unless '^''our command line s'^cifies other\vi'^'^ 
(See helovf) 



000120 016401 
000436 016401 
007462 016401 



To find a match, the search ANDs a word from 
your file with the contents of the mask register. 
If the result equals the contents of the word regis - 
ter, it is a match; if the two differ, it is not a 
match. 

Initially both mask and word registers are set to 
and the increment register is set to 1. 

After the first compare, OEDIT adds the value in the 
increment register to the starting address of the 
search for the next location. Comparing and incre- 
menting continues until it has searched all the specified 
file area. 



In this example there were three matches on your file. 

DUMP Command ($D) 

This command dumps all or part of your file to an 
output device. Unless you specify otherwise in the 
command line, it dumps the entire file. The same 
formats apply to this command as with the SEARCH 
command: 

$D 

file address $D 

file address < $D 

file address < file address $D 






$S 



Duivli uses tiie vaiue iu the iucreuient ±egistei to dunip 
only selected locations. DUMP output includes file 
addresses and the data within those locations. 



The $S will search your entire file; however, you can 
restrict the search limits by using one of the following 
command formats: 

file address $S 

searches 570ur file from the beginning to the file 
address specified, 

file address < $S 

searches your file from the address specified to the 
end of the file. 



Example: Dump words 10 through 20 in your file. 

.$J 000001 } 
.10<20$D 



In this example, you first verify the contents of the 
increment register, then enter the DUMP command. 
If the current format specifies octeil words, the output 
from this dump might look like: 

000010 005126 000023 000000 004010 
000014 001342 000000 003524 002041 
000020 005322 



file address < file address $S 
searches your file between the two specified addresses. 



Note that only one file address appears per line, but 
four file words print on each line in the octal word 
format. (If the format called for base 2, then only two 
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words would print in eacli line. ) In the alxive example 
locations 10, 11, 12, and 13 of your file print on the 
first line, words 14, 15, 16, and 17 on the second line 
and location 20 on the third line. 

FILL Command ($F) 

The FILL command writes the word in the word regis- 
ter to one or more words in your file. You first select 
the fill word and place it into the word register, and 
select the increment value and enter it into the incre- 
ment register. When you key the $F command, it 
writes the word from the word register to your file. 
As a precautionary measure, OEDIT prints "REALLY DO 
IT?" Whenever you give the FILL command; you must 
respond with the character 'Y' to execute the command. 
Any other response aborts. See the SEARCH ($S) 
command for limiting formats and their descriptions. 

Example: Fill your file from its beginning to location 
377 with the null word (000000). 

.$W 016401 O) 

.|J 000012 T2 

. 377$F 

REALLY DO IT? YES 

In this example, you first enter the fill word into the 
word register, then enter the desired increment into the 
increment register, then type the correct command. 
When OEDIT completes the fiU operation locations 
through 377 of your file contain the null word (000000). 

Print the Record Number Currently in Core ($A) 

If you entered a vsilue into the record size register, 
and you are thus editing your file in terms of record 
number: displacement , the $A command will print 
the record number for the portion of your file that you 
are presently editing. This command is useful when 
you change record lengths or when you are using a 
series of line feeds and operators in your expressions. 

. 5:31/ 034521 J 
000006 



Print Result of Expression Calculation ($C) 

The $C command calculates an expression and prints 
the result as record number : displacement . If you key 
in no expression before the $C command, OEDIT prints 
the current file location. 



.$C 

10:53 

.5+9.: 



-2$C 



16:51 

In the first example, OEDIT prints the current location; 
in the second example, it calculates and displays the 
result. 

Terminate and Return to CLI ($Z) 

This command terminates OEDIT and returns control 
to the CLI. 

Example: 



.$Z 
R 



CLI prints "R", its prompt. 

Output Format Commands 

These commands let you select the output format. 
The format you select remains in effect for all output 
until you explicitly change it. The general format 
of these commands is: 



$x 



Where x represents one of the following characters: 

= Word format 

ASCII format 
*■ Half-word octal format 

* Octal word format (number register 

changed to 8.) 
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Examples: 

•ii 

. 15+2+3= 000022 _) 
.$N 000010 10 J 

. 15+2+3= 00018 )_ 



Set to output in octal word 
format 

Display result in octal 

Set to output numbers in 
decimal 

Display expression in 
decimal 



■ $N 00010 40000+10. J Set to output in decimal, 

zero suppress 



. 15+2+3= 18 _} 
.S* 



Calculate and display 

Set to output ui octal word 
format 



. 0/ 040501 ^AA _} Display a word, display it 

in ASCII 



.$■ 



.0/ AA = 040501 ) 



.0/ AA ;^ 101 101 ) 



.0/ 101 101 X 
■0/ 040501 ) 



Set to display words in 
ASCII 

Display a word, display it 
in word format in current 
base. 

Display a word, display it 
in half-word octal format 

Set to display in octal half- 
word form 

Display a word, close it 

Set to display in word format 

Display location again 



END OF MANUAL 
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How Do You Like This Manual? 



1 itle __^^_ No. 



We wrote the book for you, and naturally we had to make certain assumptions about who you are and how you 
would use it. Your comments will help us correct our assumptions and improve our manuals. Please take a few 
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